home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 4 / United Public Domain Gold 4.iso / scope / sc093.dms / sc093.adf / LLogger / LLread.Doc < prev    next >
Text File  |  1989-12-02  |  8KB  |  174 lines
  1. -------------------------------
  2. LLREAD: Lightning Logger Reader
  3. © 1988 -1989 Ronald T.Shaw
  4. -------------------------------
  5.  
  6.      LLread, the Lightning Logger reader, offers some varied ways of
  7. obtaining general and precise lists from directory contents saved by the
  8. companion program LLog, Lightning Logger.
  9.      At the start of the LLog documentation, a simple run was detailed,
  10. producing a RAM: directory of this issue of JUMPDISK. Let's approach the
  11. reader program the same way.
  12.      If you have not turned off your computer since creating the RAM:
  13. directory of JUMPDISK, you may now use the program to work on that file.
  14.      1. Start the LLread program and choose LOAD from the pulldown PROJECT
  15. menu at upper left of screen.
  16.      2. A requester box appears, asking you to enter logged file's name.
  17. Type:
  18.  
  19. ram:hold
  20.  
  21. . . . and click the DONE box.
  22.      3. Click on the word FILES at right of screen, and this produces a
  23. volume list -- a list of logged files. If this is your first try, the only
  24. entry should be the letter J -- for JUMPDISK. Click on the J and then click
  25. the word LOAD at the bottom of the box.
  26.      4. The options beneath the word LIST at right are activated. They are
  27. DIR, OPT A, CD and LIST.
  28.      5. Click on the word LIST, and you will see an AmigaDOS-style list of
  29. files, as they are stored by the logger program.
  30.      6. Next, go to the pulldown PROJECT at top left of screen and choose
  31. the word PRT:. This activates the printer so any display you request will
  32. be put on paper. You may return control to screen display by choosing
  33. PRT: a second time. The control toggles back and forth.
  34.      There are more involved operations, which will be covered along with
  35. some standard information given in more detail.
  36.      In addition to clicking the program icon to start it, a CLI/Shell start
  37. is also possible. As the program exists on JUMPDISK, the command would be:
  38.  
  39. "j:lighting logger/llread"    <press Return)
  40.  
  41. . . . with the quote marks included.
  42.      Clicking on the bottom window gadget, which shows the name of the
  43. volume, will bring up a window with information about the currently loaded
  44. volume.
  45.  
  46. AUTO LOAD OF DEFAULT FILE
  47.      This provides for standard lists of SKIP VOLUMES, SKIP DIRECTORIES and
  48. SERIES. It pre-loads a default logger file. This default file must have the
  49. following format and can be created by ED, EDIT and most other text editors.
  50. It must exist in the sys:s directory and be named:
  51.  
  52. llg.def
  53.  
  54.      Using this file is one of the best reasons why the Lightning Logger
  55. programs should be put on a bootable Workbench disk for full use. Here is
  56. format:
  57.  
  58. VOL-SKIP list:
  59.      |VOL_SKIP|+,vol name,vol name, etc.
  60.                                 (+ means turn on the VOL-SKIP gadget)
  61.  
  62. |DIR_SKIP|+,dir name,dir name etc.
  63.  
  64. |SERIES|,volume series name
  65.  
  66. |DEFFILE|,vol:path/name
  67.  
  68. SAMPLE DEFAULT FILE:
  69. |VOL_SKIP|+,a*,bar*,pix,Work*
  70. |DIR_SKIP|,c,lib,fonts,devs,s,empty,t
  71. |DEFFILE|,sys:t/mylib
  72. |SERIES|,music
  73.  
  74. DEFAULT FILE MEANINGS
  75.      1. Insert ITEMS in volume skip list and turn on VOL-SKIP gadget.
  76.      2. When searching, skip all volumes beginning with the letters "a,"
  77. "bar" and "Work" or named "pix."
  78.      3. Insert items in directory skip list, don't turn on DIR-SKIP gadget,
  79. when searching SKIP all c, lib, fonts, devs, s, empty and t directories.
  80.      4. Load Logger file named music located in sys:t directory.
  81.      5. The series to use if series-search selected is music. This is useful
  82. if you have a series of volumes such as MUSIC1, MUSIC2, MUSIC3, etc.
  83.  
  84. FILTER MENU
  85.      VOL-SKIP: Allows bypass of selected volumes while searching. Note: The
  86. VOL-SKIP gadget must be activated.
  87.       Wild card can be used to skip volumes.
  88.       Entering A* skips all volumes beginning with the letter "A" and "a."
  89. Lightning Logger ignores differences between upper and lower case.
  90.      DIR-SKIP: Works much like VOL-SKIP but doesn't allow wild cards.
  91. Example:
  92.      Entering c, lib, libs, empty, printers, devs, fonts, etc., will skip
  93. these directories when searching.
  94.      SEARCH: Has three modes (wild card activated).
  95.      mode 1:  Name searches through volumes to find matching file names.
  96.      mode 2:  Note searches to find matching file notes.
  97.      mode 3:  Both searches for matching file names and file notes.
  98.      Example: To search for all files with a ".c" extension.
  99.       1. Select search from filter menu.
  100.       2. Select name from sub-menu.
  101.       3. Type *.c in the requester that appears.
  102.       4. If volumes are entered in volume skip list, click on VOL-SKIP
  103. gadget, which turns color when activated. If directories entered in
  104. directory skip list, click on DIR-SKIP gadget. If series is entered, click
  105. on SERIES-SEARCH and search begins. All file names ending in ".c" will be
  106. displayed on screen. If match memory is available, these matches will be
  107. held in memory to be recalled with the redisplay button until cleared, when
  108. the next search begins.
  109.  
  110. SERIES
  111.      If you have a series of similarly named volumes (example: ART1, ART2
  112. ... ART3) and you wish to search the series, select SERIES from the filter
  113. menu and enter ART (not the number) and enter the item to seek. Then click
  114. on the SERS-SEARCH gadget, and search will only search volumes belonging to
  115. this series. You can abort the search at any time with the abort button.
  116.      VOL-SKIP: If selected and volumes are entered into volume skip list,
  117. the reader will bypass these volumes when searching.
  118.      DIR-SKIP: If selected and directories are entered into dir skip list,
  119. the reader bypasses these directories when searching.
  120.      SERS-SRCH: Only searches volumes in a numbered series.
  121.      GO-SEARCH: Searches all volumes, unless VOL-SKIP activated.
  122.      RE-DISPLAY: If matching items are found and match memory is on and set,
  123. these matching items can be re-displayed or printed. Re-display can be
  124. aborted by using the ABORT gadget.
  125.       FILES: Brings up window with logged volumes. Clicking on the volume
  126. name and then clicking on LOAD will put this volume's files in memory for
  127. display or printing. Once the volumes files are loaded, the volume name and
  128. creation date are displayed. Clicking on this gadget opens a window that
  129. displays pertinent information about the selected volume. When a volume is
  130. selected and its files are loaded, the list, opt a, cd and dir gadgets are
  131. activated. They work similarly to the AmigaDOS commands with the same names,
  132. but there are a few exceptions. When using the "CD" gadget, entering ROOT:
  133. takes you back to the root directory of that volume. DIR, OPT A and LIST
  134. display files and file notes. Filenotes begin with ":" and are a different
  135. color than the regular entries.
  136.  
  137. MEMORY BUFFER
  138.      The memory buffer can be used to select the amount of memory LLread
  139. uses to hold volume records. This allows the reader to make a very fast
  140. search without going back to the disk file to re-read records -- once these
  141. records have been read once.
  142.      FILE displays the amount of memory in kilobytes reserved by the reader
  143. to hold records in memory.
  144.      MTCH displays to amount of memory reserved for matching items.
  145.      To increase or decrease FILE or MTCH, click on the number, click on UP
  146. or DN, and digits will change accordingly. If some of the memory is in use,
  147. the USE gadgets to the left will be displayed in color. To free memory in
  148. the USED gadgets, click on the USED gadget and the memory will be freed.
  149.     If the MTCH memory buffer is set to ZERO and items are found while
  150. searching, these items cannot be redisplayed because there is no memory
  151. buffer set for these items.
  152.  
  153. TO THE PRINTER
  154.      To print out only a list of volumes logged, select volume List from the
  155. MISC menu.
  156.      To print out a complete listing of the library and files, select File
  157. List from the MISC menu under Volume PRT.
  158.      To print out screen displays or matches, turn printer on from Menu
  159. "PRT:" and turn on your printer. Don't forget to set your printer in
  160. Preferences.
  161.  
  162. ON DISK
  163.      To save a file on disk:
  164.      1. Click on CMD in your Workbench system drawer.
  165.      2. Set prt: or select print option in LLread.
  166.  
  167. CL GADGET
  168.      At the bottom right corner of the LLread Window is a CL gadget.
  169. Clicking on it resizes the LLread window, which allows access to windows
  170. behind LLread. Clicking again on the CL gadget brings LLread back to full
  171. size.
  172.  
  173. END OF TEXT
  174.